home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 030a / autosn30.zip / AUTOSCAN.DOC < prev    next >
Text File  |  1991-03-11  |  14KB  |  328 lines
  1.  
  2.                ╓──╖
  3.                ║  ║
  4.                ║  ║  ╥   ╥ ╓─╥─╖ ╓───╖ ╓───  ╓───╖  ╓──╖  ╥┐   ╥
  5.               ╓╨──╨╖ ║   ║   ║   ║   ║ ║     ║      ║  ║  ║└┐  ║
  6.               ║    ║ ║   ║   ║   ║   ║ ╙───╖ ║     ╓╨──╨╖ ║ └┐ ║
  7.               ║    ║ ║   ║   ║   ║   ║     ║ ║     ║    ║ ║  └┐║
  8.               ╨    ╨ ╨───╨   ╨   ╙───╜ ────╜ ╙───╜ ╨    ╨ ╨   └╨
  9.                      v   e   r   s   i   o   n     3  .  0
  10.                 Copyright (C) 1991, /\/\ountainTop Technologies
  11.                   All Rights Reserved. Written by Nick Tucker.
  12.  
  13.  
  14.  Why the need for such a complicated algorithm?
  15.  ──────────────────────────────────────────────
  16.  There was a need for a quick and easy way checking files for viruses
  17.  on BBS systems (Recent Uploads can always be a hazard, especially when
  18.  left unattended). There are many "shells" that are available, but they
  19.  are either too slow or don't work correctly. AUTOSCAN was written to 
  20.  work with the McAffee SCAN program and various archiving programs.
  21.  
  22.  Required Files
  23.  ──────────────
  24.  PKUNZIP.EXE
  25.  PAK.EXE
  26.  PKUNPAK.EXE (or PKXARC.EXE and/or XARC.EXE)
  27.  LHARC.EXE (or ICE.EXE)
  28.  ARJ.EXE
  29.  SCAN.EXE
  30.  
  31.  (All of the current versions can be obtained from my board or the support
  32.  boards).
  33.  
  34.  How does it work?
  35.  ─────────────────
  36.  The way it works is very simple, all it does is un-archive any ZIP, ARC,
  37.  ICE, LZH, PAK, or ARJ file into a work directory (\AUTOSN), then
  38.  use McAffee's SCAN.EXE to scan it for any virus (Since SCAN is updated
  39.  regularly, you don't have to worry about AutoScan becoming outdated or
  40.  missing any recent viruses.) If all goes well and no viruses are found,
  41.  it deletes all the "work" files and then moves onto the next file and
  42.  repeats the process.
  43.  
  44.  To get going is real simple, copy AUTOSCAN.EXE into a directory in your
  45.  path ( example in AUTOEXEC.BAT:
  46.  
  47.  PATH = C:\;C:\UTIL;
  48.  
  49.  when AUTOSCAN.EXE is in C:\UTIL ).  Change to the directory you wish to
  50.  scan, and type "AUTOSCAN". 
  51.  AutoScan will then look through the Current Directory for ZIP, ARC, 
  52.  ICE, PAK, LZH, ARJ and SDN files, un-archive them and scan them, if all
  53.  goes well it will proceed onto the next file. In order for everything to
  54.  work all the un-archivers should be within reach upon the currect path,
  55.  PKUNPAK.EXE, PKUNZIP.EXE, LHARC.EXE, ICE.EXE, PAK.EXE, ARJ.EXE and, most
  56.  importantly, SCAN.EXE.  If any of the un-archivers are not found that 
  57.  section will not execute, you don't need them all to run AUTOSCAN, 
  58.  however if SCAN.EXE is not located the program will halt.
  59.  
  60.  AutoScan will keep a detailed log of it's activities in the same
  61.  directory that contains AUTOSCAN.EXE appropriately named AUTOSCAN.LOG. 
  62.  If it already exists, new information will be appended to it.
  63.  
  64.  "What if?" he said
  65.  ──────────────────
  66.  What if there is an archive within an archive? AutoScan will detect if there
  67.  are any archives within archives - to any level and any combination of
  68.  archive types. If an error is located in a "sub archive" that name is placed
  69.  in the log along with the main archive name and what the error was - Virus
  70.  or bad archive.  
  71.  
  72.  About ARC
  73.  ─────────
  74.  AutoScan supports most major ARC type archivers, PKPAK, PKARC and the SEA
  75.  ARC7, it can tell the difference between the three and will use the 
  76.  appropriate archiver to un-archive the file. If AutoScan detects a file
  77.  generated by the ARC7 archiver and XARC is not available that file will be 
  78.  skipped, however if XARC is found and PkPak or PkArc isn't, AutoScan will 
  79.  attempt to use ARC7 for the Arc type unarchiver.
  80.  
  81.  About PAK
  82.  ─────────
  83.  AutoScan, when examining a PAK archive, will only un-archive the type 10
  84.  compression (Crushed) and the type 11 compression (Distilled).
  85.  
  86.  
  87.  COMMAND LINE OPTIONS
  88.  ────────────────────
  89.  AUTOSCAN /S
  90.  If you wish to have your Hardrive scanned as well put a /S on the command
  91.  line.  Drives C: through H: will be scanned if they exist. Only EXE, COM,
  92.  SYS, PIF and OVR files will be checked.
  93.  
  94.  AUTOSCAN /Q 
  95.  When AutoScan finishes it sounds a two tone bell a few times, or in the
  96.  case of a VIRUS, many times! If you wish to run it in the QUIET MODE put
  97.  a /Q on the command line.
  98.  
  99.  AUTOSCAN /C 
  100.  This will trick AutoScan into thinking that there is a virus, and will do
  101.  the following:
  102.  1. Rename the archive to .BAD
  103.  2. Exit at an errorlevel of 1
  104.  
  105.  You must have an archive in the current directory (ALONG WITH CHECK.EXE)
  106.  to use this.  You may use no other command line options.
  107.  
  108.  AUTOSCAN /R
  109.  AutoScan will rescan all files archives. This option is as if you had 
  110.  deleted AutoScan.Dat, which is exactly what AutoScan does.
  111.  
  112.  AUTOSCAN /M
  113.  AutoScan will instruct Scan.exe not to scan RAM at all. Without this option
  114.  RAM will be scanned only on the first pass or if a virus was found RAM will
  115.  be scanned again.
  116.  
  117.  AUTOSCAN /O
  118.  To scan a single file. This will not enter the name into AUTOSCAN.DAT, or
  119.  even check to see if it has been processed before. Just a quick and dirty
  120.  scan. IE: AUTOSCAN /OTEST.ZIP 
  121.  A path and file name can be specified, sorry no wildcards.
  122.  
  123.  AUTOSCAN /F
  124.  This will instruct AutoScan to reboot the machine once all operations have
  125.  been completed, a five (5) second count down can be aborted by pressing any
  126.  key. This feature is usefull if you are doing an entire drive scan and don't
  127.  want to sit around watching it run, when it's done it will reboot and bring 
  128.  up your BBS or Menu system if you have one. 
  129.  
  130.  AUTOSCAN /N  * - Registered Version.
  131.  This will instruct AutoScan to check for Bad Archives ONLY, only use this
  132.  option if you are sure the file is free of Virus's. 
  133.  
  134.  AUTOSCAN /A  * - Registered Version.
  135.  AUTOSCAN will search the ENTIRE DRIVE for archives and scan them. AUTOSCAN
  136.  will not update the AUTOSCAN.DAT or check to see if the file has been
  137.  processed. IE: AUTOSCAN /AC: If no drive is specified the default is used.
  138.  
  139.  AUTOSCAN /T  * - Registered Version.
  140.  This will instruct AutoScan to check the size, time and date of the archive.
  141.  If it has changed, the archive will be rescanned. If you run AutoScan from a
  142.  BBS to check any recent uploads you might not want to use this option. If you
  143.  add ZIP comments to a file, it will obviously change the file size and cause
  144.  AutoScan to rescan it.
  145.  
  146.  AUTOSCAN /D  * - Registered Version.
  147.  With this option you can specify the directory to scan on the command line.
  148.  IE: AutoScan /DF:\WORK . Any files in the F:\WORK directory will be scanned.
  149.  
  150.  AUTOSCAN /I  * - Registered Version.
  151.  All this does is supress the blue or red box upon completion, the same info
  152.  is written to the screen in a "normal manner".
  153.  
  154.  AUTOSCAN /B  * - Registered Version.
  155.  To direct AutoScan to place any .BAD files in a specified directory.
  156.  IE: AUTOSCAN /BC:\BADFILES  where C:\BADFILES is the directory.
  157.  
  158.  All command line options must be seperated by a space and they may be in 
  159.  any order you wish. 
  160.  
  161.             AUTOSCAN /Q /R /BC:\BADFILES /I /DE:\RECENT
  162.  
  163.  This would cause AUTOSCAN to run in Quiet Mode (/Q), rescan all files (/R),
  164.  copy all .BAD files to C:\BADFILES (/B), supress the ending screen (/I), 
  165.  and examine the directory E:\RECENT (/D). The Command line is limited to 
  166.  80 characters so keep those paths small!!
  167.  
  168.  AUTOSCAN.CFG
  169.  ────────────
  170.  Included in the Archive is a file called AutoScan.Cfg. In this file you can
  171.  set certain default settings for AutoScan. Edit this file with an ASCII editor
  172.  to suit your liking. If you wish to use different config files you can specify
  173.  the name on the command line with the /K option.
  174.  AUTOSCAN /KC:\AUTOCFG.CFG would cause AutoScan to use the Autocfg.Cfg file
  175.  in the root directory of drive C:. This option MUST BE THE FIRST OPTION 
  176.  otherwise it will be ignored. You can add further options on the command line
  177.  after the /k option, IE: AutoScan /KC:\AUTOCFG.CFG /R /I .
  178.  
  179.  HELP and SCAN.EXE
  180.  ─────────────────
  181.  For help on the fly type AUTOSCAN ? and it will display some information
  182.  about itself.
  183.  
  184.  In order for AutoScan to detect all known virus's you must keep your
  185.  version of SCAN.EXE as current as possible. AutoScan is only as good
  186.  as the Scanner it uses. SCAN.EXE can be found on most good bulletin 
  187.  boards in your area. 
  188.  
  189.  *.BAD
  190.  ─────
  191.  If AutoScan comes across a bad archive or a virus that file will be
  192.  renamed to "filename".BAD and make a note in the log indicating which
  193.  file is SUSPECT of being bad. If a file is flagged as being bad you 
  194.  might want to examine it manually to see why. If the /B option was used
  195.  that file would be copied to the specified directory.
  196.  
  197.  NEWLIST.TXT
  198.  ───────────
  199.  As AutoScan runs it generates a file called NEWLIST.TXT. In this file it
  200.  will place the names of any new files that it has just processed. If you
  201.  have an archive commenter that can use this file then please do. I am in
  202.  the process of writing one for ZIP files and it should be released soon.
  203.  
  204.  F10 - ABORT 
  205.  ───────────
  206.  While AutoScan is running pressing  F10 will cause AutoScan to abort the
  207.  current session.  AutoScan will only stop once the current file has been
  208.  finished and the work files have all been deleted. AutoScan will report on
  209.  the current status of it's operation and further runnings of AutoScan will
  210.  just pick up where it left off.  AutoScan will exit on an ERRORLEVEL of 0
  211.  in this case.
  212.  
  213.  AUTOSCAN.DAT
  214.  ────────────
  215.  Once AutoScan has completed its operations it will update a file called
  216.  AUTOSCAN.DAT, this file contains a list of files that have already been
  217.  scanned.  For sysops, this makes it possible to run AutoScan after users
  218.  have logged off the BBS, and if any new files were uploaded, they get
  219.  scanned right away and removed from circulation if needed. 
  220.  
  221.  The Naughty Bits
  222.  ────────────────
  223.  Each time AutoScan starts up it checks it's own size and CRC, and if it
  224.  has changed, it will terminate with a nasty message. AutoScan will also
  225.  check disk space each time it starts up. If the amount of disk space left
  226.  is less than 150% of the archive size AutoScan will exit on a ErrorLevel 1.
  227.  
  228.  Errorlevels
  229.  ───────────
  230.  AutoScan will exit on one of 5 DOS ErrorLevels..
  231.  
  232.            ErrorLevel 0 - New Files found and processed.
  233.            ErrorLevel 1 - SCAN.EXE missing / No Disk Space /
  234.                           AUTOSCAN.EXE infected / File Error.
  235.            Errorlevel 2 - No New Files. 
  236.            ErrorLevel 3 - Bad Archive, Renamed to .BAD.
  237.            ErrorLevel 4 - VIRUS, Renamed to .BAD.
  238.  
  239.  What In?
  240.  ────────
  241.  AUTOSCAN is written in Turbo Pascal 6.0 and some routines are from
  242.  the TechnoJock Turbo Toolkit V5.02 (excellent package if your a TP 4/5/6
  243.  programmer).
  244.  
  245.  AUTOSCAN uses many "outside" programs, without which AUTOSCAN would not
  246.  function. Please show your appreciation and register these fine programs.
  247.  
  248.  What If?
  249.  ────────
  250.  If AUTOSCAN does report that SCAN.EXE found a virus, what do I do?  Either
  251.  contact McAffee Associates, and they can guide you through getting rid of
  252.  the virus, or you can run SCAN.EXE manually with a /D on the command line.
  253.  SCAN /D will delete any file found with a virus.  Also Mace Utilities 1990
  254.  and CLEANPxx.ZIP will get rid of any viruses after they are detected.
  255.  
  256.  The key to virus protection is that ugly word "BACKUP"!  Always backup any
  257.  critical files that you may have.  
  258.  
  259.  The Best
  260.  ────────
  261.  This program would not be possible without the creation of these fine
  262.  programs:
  263.  
  264.  PKZip / PKPak  -  PKWare / Phil Katz             -  PKZ110.EXE
  265.  
  266.  PAK            -  NoGate Programming             -  PAK251.EXE
  267.  
  268.  ARC,XARC       -  System Enhancement Associates  -  N/A
  269.  
  270.  Lharc (LZH)    -  Yoshi                          -  LH114B.EXE
  271.  
  272.  Turbo Pascal   -  Borland Corporation            -  N/A
  273.  5.5 / 6.0
  274.  
  275.  TechnoJock     -  TechonoJock Software           -  TTT502.ZIP
  276.  5.02 
  277.  
  278.  SCAN           -  McAffee Associates             -  SCANV72.ZIP
  279.  
  280.  
  281.  The Rest  
  282.  ────────
  283.  AutoScan is distributed under the Shareware concept, and you are given a
  284.  LIMITED contract to use AutoScan.   You may use it free of charge for a
  285.  period of THIRTY (30) DAYS, and then you must register it. There is a
  286.  registration fee of $10.00 US dollars ($15.00 Canadian) which will entitle
  287.  you to the next version of AutoScan. See REGISTER.NOW for more details. A
  288.  lot of work has gone into creating this program, and if you would like to
  289.  see it continue, please contribute.  
  290.  
  291.  The author shall not be held responsible for any hardware or software damage
  292.  associated.  You are using this program at your own risk.
  293.  
  294.  You are NOT allowed to distribute this program for any money, but are able
  295.  to distribute it for fee but only for the amount of the disk and/or the 
  296.  price of postage.
  297.  
  298.  Final Word
  299.  ──────────
  300.  Thank you to everyone who helped out with the nasty task of debugging
  301.  this thing...THANKS! THANKS! THANKS!...
  302.  
  303.  Thanks to Eric Boehm for putting the seed to this program in my head and
  304.  testing many different versions in the same day! 
  305.  Thanks to all those in the Pascal Echo who help me with some of the
  306.  stranger points in this program. You can always find me in there! 
  307.  Thanks to Josh for help with these docs..
  308.  
  309.  My Beta testers:
  310.   Josh Linder, Rich Lowenburg, Bob Moravsik (The infamous!!!) and Eric
  311.   Boehm and all the others who moaned about the Runtime Error 5 and 6
  312.   of Version 2.0!.
  313.   
  314.  Where to find me
  315.  ────────────────
  316.  Somewhere in the FidoNet Pascal Echo.
  317.  
  318.  or my mailing address:
  319.  
  320.        /\/\ountainTop Technologies
  321.        91 Sage Court
  322.        Bedminster NJ, 07921  USA
  323.        ATTN: Nick Tucker..
  324.  
  325.   Thank you for using /\/\ountainTop Technologies for you computing needs.
  326.   We offer a full line of software packages, write for details...
  327.  
  328.